home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / tdxlpcb2.arc / TDXL.DOC < prev    next >
Text File  |  1991-10-04  |  33KB  |  993 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                   TDXL.EXE - TSR Documentation Release 1.0b  
  9.  
  10.  
  11.  
  12.  
  13.                             - Operation Manual - 
  14.  
  15.  
  16.  
  17.                              Copyright (C) 1991
  18.  
  19.                               Fred Bertagnolli
  20.  
  21.                              All Rights Reserved
  22.  
  23.  
  24.  
  25.  
  26.                            TDXL was written using 
  27.                      Borland International Inc. TurboC(R)  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                   To Register this program send $15 U.S. to:         
  35.  
  36.                    
  37.                               Fred Bertagnolli
  38.                               TDXL Program
  39.                               745 Maple St.
  40.                               Ogden, Utah  84403 
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                 ---------------------------------------------- 
  50.  
  51.                 Please support the "SHAREWARE" concept and the
  52.                 policies of all "SHAREWARE" software authors. 
  53.  
  54.                 ---------------------------------------------- 
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                   - 1 -
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                           - INTRODUCTION to TDXL -
  69.  
  70.          
  71.     TDXL is a TSR (Terminate and Stay Resident) program that facilitates
  72.     the creation of PCBoard @X format color text screens.  TDXL allows
  73.     PCBoard BBS Sysops and Screen Designers to use TheDraw(TM) to create
  74.     Newsfiles, Bulletins and Welcome color text screens.
  75.  
  76.  
  77.     Pressing Ctrl-T activates TDXL, while in TheDraw, and allows you to
  78.     View, Load and Save PCBoard @X formats directly.  This eliminates the
  79.     need to create ANSI.SYS color text screens and then convert them.
  80.  
  81.  
  82.     Note:  TheDraw(TM) is a well supported "shareware" color text screen
  83.            drawing program, available on many Bulletin Boards.  TheDraw
  84.            has many useful features for the creating screens.  It is
  85.            recommended that you use TheDraw version 3.3 or later with
  86.            TDXL.
  87.  
  88.     TheDraw(TM) is Copyright by Ian E. Davis and TheSoft Programming
  89.     Services.  Fred Bertagnolli is not an associate of Ian E. Davis.
  90.     Please support the "shareware" policies of TheDraw.
  91.  
  92.  
  93.       ---------    IMPORTANT NOTICE TO ALL USERS OF TDXL   ----------
  94.  
  95.    IMPORTANT:  TDXL will only work if TheDraw program name is unchanged.
  96.  
  97.  
  98.         ***   DO NOT RENAME THEDRAW.EXE  to another .EXE name.   *** 
  99.  
  100.         ***   DO NOT RENAME THEDRAWR.EXE to another .EXE name.   ***  
  101.  
  102.       ---------------------------------------------------------------
  103.  
  104.      Release History:
  105.                                                                         
  106.      10-01-91   TDXL  Rel. 1a  Posted on Salt Air PCBoard Sysop BBS.
  107.  
  108.      10-03-91   TDXL  Rel. 1b  Bug fix for MCB's.
  109.                       
  110.               
  111.  
  112.                                          
  113.     NOTE: TDXL does not support multiple loaded copies of TheDraw.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                    - 2 -
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                         - Overview of TDXL Features -
  131.  
  132.  
  133.  
  134.   o  TDXL was designed to replace CONVERT, EXLIST and PCBdraw, when used
  135.      with TheDraw.  Most PCBoard Sysops are familiar with these programs,
  136.      and their limitations and drawbacks.
  137.  
  138.   o  Your screen designs will display and scroll correctly when saved by
  139.      TDXL, without color wrap around problems, and are compressed to
  140.      a minimum file size.
  141.                
  142.   o  TDXL can GRAB color text screens while you are ON-LINE, and saves
  143.      the screen in compressed PCBoard @X format. 
  144.  
  145.   o  TDXL can be used with or without TheDraw.  For example, you can TYPE
  146.      an ANSI.SYS color screen, and save it to @X format.
  147.  
  148.   o  You can view existing PCBoard @X files anytime.
  149.  
  150.   o  Use of TDXL eliminates the need for backup ANSI.SYS files of your
  151.      PCBoard screens.
  152.  
  153.   o  Using TDXL with TheDraw is a better drawing environment than other
  154.      systems that write @X commands directly.    A few reasons are:
  155.      TheDraw supports a mouse, multiple pages, and can import many text
  156.      file formats.  Screen designing is EASY with TheDraw.
  157.  
  158.   o  TDXL supports loading @X screens or text files longer than 25 lines
  159.      and can load @X files to any Page of TheDraw.
  160.  
  161.   o  We have included features you will enjoy using.  TDXL allows you to
  162.      scroll through long text files or PCBoard format files, and you can
  163.      insert just the Page you want directly into TheDraw for further
  164.      colorization/editing.
  165.               
  166.   o  TDXL is extremely easy to use.  It allows saving of 1 to 25 screen
  167.      lines, allows adding an @CLS@, and automatically compresses the
  168.      @X file to a minimum size.  You also have control over the last
  169.      CR-LF in the file.
  170.  
  171.   o  TDXL is written in 'C' by a professional programmer with 10 years
  172.      programming experience.  TDXL output has been tested using two
  173.      different PCBoard BBS systems with no problems.
  174.  
  175.   o  Registered Users of TDXL will receive a password which enables
  176.      some additional features built into TDXL, including the ability
  177.      to save long files to multiple pages and to view screens in black
  178.      and white mode.  Registration will also remove the "SHAREWARE"
  179.      reminder that appears on line 24 of the non-registered version. 
  180.      We do not apologize for this minor annoyance.  It is intentional.
  181.      Note that the reminder DOES overwrite part of line 24, and appears
  182.      each time you Load a file.
  183.  
  184.  
  185.  
  186.                                    - 3 -
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.            TDXL-PCB.ZIP should contain the following files:
  194.  
  195.            TDXL.DOC             TDXL.EXE              TDXL.HLP
  196.  
  197.            and the following PCBoard @X format sample screens.
  198.  
  199.            SAMPLE1.PCB          SAMPLE2.PCB           SAMPLE3.PCB
  200.            SAMPLE4.PCB          SAMPLE5.PCB           SAMPLE6.PCB
  201.            SAMPLE7.PCB          SAMPLE8.PCB           SAMPLE9.PCB
  202.  
  203.  
  204.  
  205.  
  206.                            - Table of Contents -
  207.  
  208.  
  209.           Introduction to TDXL ...............................  2
  210.  
  211.           Overview of TDXL features ..........................  3
  212.  
  213.           Files contained in TDXL-PCB.ZIP ....................  4 
  214.  
  215.           TDXL Software License Agreement ....................  5
  216.  
  217.           Distribution Policy ................................  5
  218.  
  219.           Warranty Disclaimer ................................. 6 
  220.  
  221.           TDXL Price List and Ordering Information ............ 7
  222.  
  223.           Installation and Removal of TDXL TSR ................ 8
  224.  
  225.           TDXL Main Menu ...................................... 9
  226.  
  227.           TDXL View Option .................................... 10
  228.  
  229.           TDXL Load Option .................................... 11-12
  230.  
  231.           TDXL Save Option .................................... 12-13
  232.  
  233.           TDXL Help List for PCBoard Screen Designers.......... 14-15
  234.  
  235.           Acknowledgements .................................... 16 
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.                                    - 4 -
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.                      - TDXL Software License Agreement -
  256.  
  257.  
  258.      TDXL is not a Public Domain program and as such IS NOT "Freeware."
  259.      TDXL is Copyright (C) 1991 by Fred Bertagnolli, the sole author
  260.      and owner of the TDXL program and accompanying documentation.
  261.        
  262.      Non-registered users of TDXL are granted a limited 15 consecutive
  263.      day license to use TDXL for evaluation purposes only.
  264.  
  265.      Continued use of TDXL after the 15-day period requires registration
  266.      and payment for each copy of the program used.  Please support the
  267.      "Shareware" concept.
  268.  
  269.      TDXL may NOT be modified in any respect, for any reason, including
  270.      but not limited to, de-compiling, disassembling, reverse engineering,
  271.      or changing text in the TDXL.EXE program or documentation.
  272.  
  273.      Use of this software is just like a book, in that the software
  274.      may be used only by one person at a time, provided there is no
  275.      possibility of two people using the software at the same time.
  276.        
  277.      Registered owners of the software license may make one backup
  278.      copy of TDXL for archival purposes only, and to protect your
  279.      investment from loss.
  280.  
  281.      Registered owners of the TDXL software license are forbidden
  282.      from sharing information or passwords which allow non-registered
  283.      users to upgrade the software.  Release of your password shall
  284.      be interpreted as a violation of U.S Copyright Laws, intent to
  285.      defraud the author of his rights to the TDXL program, and cancels
  286.      your software license.
  287.  
  288.      The software license is non-transferable.
  289.  
  290.  
  291.  
  292.                         - Distribution Policy -
  293.  
  294.  
  295.      BBS Sysops may distribute only the shareware version of TDXL,
  296.      provided that no distribution fees of any kind are charged,
  297.      and that TDXL package and files have not be altered.
  298.  
  299.      "Shareware" distribution firms must acknowledge on the distribution
  300.      media, that a license is NOT being granted for the use of TDXL.
  301.  
  302.      Suggested BBS file listing for the TDXL-PCB.ZIP package is:
  303.  
  304.      TDXL-PCB.ZIP    Shareware TSR for TheDraw to create PCBoard @X
  305.                      screens. View, Load and Save @X format files from
  306.                      within TheDraw. Can replace CONVERT, EXLIST, and
  307.                      PCBdraw.
  308.  
  309.  
  310.                                    - 5 -
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.                                - Disclaimer -
  318.      
  319.  
  320.       No warranties or guarantees of any kind are implied or given for
  321.       use of the TDXL program or the accuracy of this document.
  322.  
  323.              * * *   Use this program at your own risk.  * * *
  324.  
  325.       Fred Bertagnolli disclaims all warranties, expressed or implied.
  326.       In no event will Fred Bertagnolli be liable for any loss of profit
  327.       or other commercial damage, including but not limited to special,
  328.       incidental, consequential or other damages.  
  329.  
  330.  
  331.                    --------------------------------------
  332.  
  333.                            
  334.       This software requires an IBM compatible PC, DOS 3.0 or higher,
  335.       and CGA/EGA/VGA or Monochrome graphics card.  Hard disk and 640K
  336.       main memory recommended.
  337.  
  338.  
  339.       If you have a problem with TDXL, please contact the author via
  340.       mail and describe the situation (please read all the documentation
  341.       before contacting the author).  We have tested the program on
  342.       many different machines using DOS 3.3 and DOS 4.01.  Honest
  343.       criticism and suggestions are welcomed.   Requests for changes or
  344.       feature enhancements from Registered Users will be given first
  345.       priority.
  346.  
  347.  
  348.       Brands and product names mentioned in this document are trademarks
  349.       or registered trademarks of their respective holders or companies.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.         
  357.  
  358.  
  359.        
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.                                    - 6 -
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.     Registration of TDXL is REQUIRED after the 15 day evaluation period.
  380.  
  381.  
  382.                            - TDXL Price List -
  383.    ---------------------------------------------------------------------  
  384.  
  385.       Evaluation Copy     $5.00    Plus a floppy disk supplied by you.
  386.  
  387.     Full Registration    $15.00    You receive "passwords" via U.S. Mail
  388.        for BBS Sysops              to remove "Shareware" notice and to
  389.                                    activate additional features of TDXL
  390.  
  391.     Full Registration    $20.00    As above.  Disk and "passwords"
  392.      with floppy disk              sent by mail.
  393.  
  394.           Upgrades to     $5.00    Plus floppy disk supplied by you. Disk
  395.       Registered User              must contain a fully operational TDXL,
  396.                                    as upgraded by previous "Password"
  397.                                    information.  (when available)
  398.         Tax Supported
  399.          Institutions    $55.00    Full Registration and disk by mail.
  400.      Corporations and           
  401.  All Commercial Users
  402.  
  403.    ---------------------------------------------------------------------  
  404.  
  405.    All prices are U.S. funds.  Foreign currency or foreign checks not
  406.    accepted.  
  407.  
  408.  
  409.  
  410.         All Check's or Money Orders Payable To:  Fred Bertagnolli
  411.  
  412.                Send to:    Fred Bertagnolli
  413.                            TDXL Program
  414.                            745 Maple St.
  415.                            Ogden, UT  84403
  416.     
  417.               --------------------------------------------    
  418.  
  419.    We may, at our discretion, send notification of upgrades and/or program
  420.    disks to registered users.   This will depend on user support of the
  421.    TDXL shareware policies.   We feel the asking price is well within the
  422.    budget of any Sysop.  We ask for YOUR support, since TDXL is addressed
  423.    to a relatively small audience of users.
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.                                    - 7 -
  435.  
  436.  
  437.  
  438.  
  439.               - Installation of TDXL Non-Registered version -
  440.  
  441.  
  442.   TDXL is a TSR.  Always load this program from the DOS command line
  443.   before running any other programs.  Never load any TSR while in a
  444.   DOS SHELL.
  445.  
  446.   Note: TSRs sometimes conflict with each other; therefore, it is
  447.         recommended that you do not have other TSR programs in memory
  448.         while running TDXL. If you do have multiple TSRs and experience
  449.         problems, then try loading the TSRs in a different order.
  450.  
  451.    All TDXL DOS command lines assume you are in the Directory where
  452.    TDXL.EXE is located.  Recommend installation of TDXL.EXE on a hard
  453.    disk.  TDXL.HLP must be in the same Directory as TDXL.EXE.
  454.  
  455.  * TO LOAD TDXL TSR...             at the DOS Command Line prompt type:
  456.  
  457.     TDXL
  458.  
  459.     TDXL now installed!
  460.     Press CTRL-T to activate the TSR
  461.  
  462.                        ------------------------------   
  463.  
  464.  * TO REMOVE TDXL from MEMORY...  at the DOS Command Line prompt type:
  465.  
  466.     TDXL QUIT
  467.  
  468.     TDXL now removed!
  469.  
  470.                        ------------------------------   
  471.                             
  472.  * ACTIVATING the TDXL TSR...
  473.  
  474.    Press CTRL-T (the hot key) while running THEDRAW.EXE  A TDXL main
  475.    menu window pops-up and is ready to View, Load or Save @X files.  
  476.  
  477.                        ------------------------------
  478.  
  479.  * SPECIAL TDXL Command Lines...
  480.  
  481.   Special commands that some users may wish to use if the CTRL-T
  482.   hot key conflicts with other program controls (normally not used):
  483.  
  484.    TDXL wait     Puts TDXL on temporary hold, if it is already in memory.
  485.                  This deactivates the CTRL-T hot key.  
  486.  
  487.    TDXL restart  Restarts TDXL if it was on hold, and reactivates the
  488.                  CTRL-T hot key.
  489.  
  490.  
  491.    TDXL uses about 28K of memory when loaded.  We recommend that you
  492.    use the QUIT command line to remove TDXL from memory when you have
  493.    finished.  This will make the 28K of main memory available to
  494.    other programs.
  495.  
  496.                                    - 8 -
  497.  
  498.  
  499.  
  500.  
  501.  
  502.                       - TDXL Operation and Commands -
  503.  
  504.  
  505.          Main Menu: Pops-up after loading TDXL and pressing CTRL-T.  
  506.  
  507.  
  508.  
  509.                     -------------[ TDXL ]------------
  510.                     | Unregistered          Rel. 1a |
  511.                     |                               |
  512.                     |   V)iew     L)oad     S)ave   |
  513.                     |                               |
  514.                     |                               |
  515.                     |  [Esc]:Exit        Help:[F1]  |
  516.                     |                               |
  517.                     |    PCBoard BBS @X Screens     |
  518.                     --Copyright 1991 F. Bertagnolli--
  519.  
  520.  
  521.  
  522.  
  523.    The 3 options here are for View, Load, and Save a PCBoard @X file. 
  524.  
  525.  
  526.    Press:  V, L, or S to access the menu options.
  527.  
  528.    Press:  Esc to exit TDXL and return to TheDraw. 
  529.  
  530.    Press:  F1 to see the single help screen.  TDXL.HLP (the Help file)
  531.            must be in the same Directory as TDXL.EXE.    
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.                                    - 9 -
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.   V)iew:  View a PCB @X file or a text file, then restore previous
  566.           screen.
  567.  
  568.                       -------------[ View ]------------
  569.                       | Filename to View:             |
  570.                       |[_____________________________]|
  571.                       |                               |
  572.                       |  Display in Color : Y/N [ ]   |
  573.                       |  Reg. option                  |
  574.                       |                               |
  575.                       |                               |
  576.                       |                               |
  577.                       ----------------- [Esc]:Cancel --
  578.  
  579.  
  580.  o  Filename to View:  May have a Directory Path included with the
  581.                        filename; i.e.,  D:\DIR\PCBFILE.PIC
  582.  
  583.  o  You may press Esc at any time to cancel the field edit and
  584.     return to the Main Menu.
  585.  
  586.  o  If the 1st character of an existing file does not begin with @,
  587.     you are prompted: @ NOT FOUND! Proceed: Y/N [N].
  588.  
  589.     TDXL assumes that PCBoard @X files always begin with @. "Proceed"
  590.     is used to remind you the filename you entered is probably
  591.     not a PCBoard @X format file.  However, you may proceed with a Y
  592.     response and view ASCII text files.
  593.  
  594.     Files longer than 25 lines are prompted:
  595.  
  596.     [ More: Any Key or Esc ]
  597.  
  598.     at the bottom of the screen.  Pressing Any Key will scroll through
  599.     file, line by line.  Pressing Esc will show how many lines were in
  600.     that file, and waits for an additional Esc key press.   
  601.  
  602.  o  Note that TDXL does not support ANSI.SYS control codes.  Use TheDraw
  603.     to load in an existing .ANS file.  Then use TDXL to convert them to
  604.     PCBoard @X format.
  605.  
  606.  o  Display in Color:  is available only in the registered version.
  607.     This option is useful for viewing a PCBoard @X format file, in
  608.     black and white, and provides a means of seeing what the on-line
  609.     screen will look like if a user has color turned off.
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.                                    - 10 -
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  L)oad:  Loads a PCB @X file starting at (1,1).  If TheDraw(tm) is running,
  627.          prompts for PAGE #.  Draws to the video page and copies to TheDraw
  628.          page buffer. The current TheDraw Page should match PAGE # selected.
  629.                     
  630.                       -------------[ Load ]------------
  631.                       | Filename to Load:             |
  632.                       |[_____________________________]|
  633.                       |                               |
  634.                       |      TheDraw PAGE : 1-8 [ ]   |
  635.                       |                               |
  636.                       |   Page # is the active page   |
  637.                       |   of TheDraw, when running.   |
  638.                       |                               |
  639.                       ----------------- [Esc]:Cancel --
  640.  
  641.  o  Filename to Load:  May have a Directory Path included with the
  642.                        filename; i.e.,  D:\DIR\PCBFILE.PIC
  643.  
  644.  o  You may press Esc at any time to cancel the field edit and
  645.     return to the Main Menu.
  646.  
  647.  o  If the 1st character of an existing file does not begin with @,
  648.     you are prompted: @ NOT FOUND! Proceed: Y/N [N].
  649.  
  650.     TDXL assumes that PCBoard @X files always begin with @. "Proceed"
  651.     is used to remind you the filename you entered, is probably not
  652.     a PCBoard @X format file.  However, you may proceed with a Y
  653.     response and LOAD ASCII text files of any size.
  654.  
  655.  o  TheDraw Page: 1-8 is accessed only if you are currently running TDXL
  656.                       within TheDraw.  The default page is 1.  You
  657.                       should first be on the specified TheDraw Page
  658.                       before loading to it.
  659.  
  660.     For example: If you are on Page 1 and tell TDXL to load to Page 8, the
  661.                  current Page 1 screen will be temporarily overwritten.
  662.                  This happens because TDXL has no way of knowing what Page #
  663.                  you are currently displaying with TheDraw.  TDXL will load
  664.                  TheDraw Page 8 with the file, but Page 1 will not contain
  665.                  current screen data.  To refresh TheDraw screen, after
  666.                  exiting TDXL, use TheDraw command ALT-E PAGE# to redraw/or
  667.                  move to the desired Page #.
  668.  
  669.  o  Files longer than 25 lines are prompted with:
  670.  
  671.     [ More: Any Key or Esc ]
  672.  
  673.     at the bottom of the screen.  Pressing Any Key will scroll through
  674.     the file, line by line.  Pressing Esc will Load the current screen
  675.     into TheDraw, and will show you the number of lines in that file.
  676.     Pressing Esc again, exits TDXL and returns you to TheDraw.
  677.  
  678.     Lines longer than 80 characters are truncated.
  679.  
  680.  
  681.  
  682.                                    - 11 -
  683.  
  684.  
  685.  
  686.  
  687.     Load: continued
  688.  
  689.  o  After a Load, when running TDXL and TheDraw, TDXL moves the cursor
  690.     to position (1,1).  Line 24 of the non-registered version is
  691.     overwritten by intentional "Shareware" reminder.  If you have
  692.     not registered TDXL, please do not complain about this annoyance.
  693.  
  694.  o  By the way, the scrolling Load feature of TDXL is something TheDraw
  695.     cannot normally do.
  696.  
  697.  o  These PCBoard @Commands@ are ignored during View/Load, since they
  698.     are not displayed on-line and they do not expand any system information:
  699.  
  700.     @CLS@, @POFF@, @QOFF@, @PON@, @QON@, @MORE@, @PAUSE@ and @AUTOMORE@.
  701.  
  702.     All other @Commands@ may be included in a screen design: i.e., @USER@,
  703.     and will be Loaded with TDXL.  Except for @CLS@, SysOps should add
  704.     these non-expanding @'s to a saved file, manually.  Or put them on the
  705.     first line of the screen design, followed by an @CLS@ command.
  706.  
  707.  o  Note to Non-Sysops:  Most sysops do not like users to use any of the
  708.     color code commands in uploaded messages.  Please abide by local Sysop
  709.     customs, and do not use TDXL to create screens which are not Sysop
  710.     approved.  It is also worth mentioning, that @X color codes are not
  711.     recognized by many off-line mail reader programs, including SLMR 2.0.
  712.  
  713.                  -------------------------------------------   
  714.  
  715.  S)ave:  Saves the current screen to PCB @X format.   Prompts for number of
  716.          Rows to Save.  Allows adding an @CLS@.  Allows control over a CR/LF
  717.          at the end of the Saved file.  Save always starts at position (1,1).
  718.  
  719.                       |------------[ Save ]-----------|
  720.                       |                               |
  721.                       |     Ending Row   : 1-25 [23]  |
  722.                       |     Insert CLS   :  Y/N [N]   |
  723.                       |     Insert CR/LF :  Y/N [Y]   |
  724.                       |                               |
  725.                       | Filename to Save:             |
  726.                       |[_____________________________]|
  727.                       |                               |
  728.                       |---------------- [Esc]:Cancel -|
  729.  
  730.  o  Ending Row: 1-25   Enter the last Row Number (screen line) you wish
  731.                        to save.  A column of Row numbers appears temporarily
  732.                        on the Left side of the screen, showing the current
  733.                        row number in Red.
  734.  
  735.  o  Insert CLS         If Y is selected, @CLS@ will be inserted at the
  736.                        first position in the Saved file.
  737.  
  738.  o  Insert CR/LF       If N is selected, the last line in the file will
  739.                        not have a Carriage Return / Line Feed combination.
  740.                        This is useful for displaying a full 23 lines when
  741.                        on-line, without scrolling off the screen.
  742.  
  743.  
  744.                                    - 12 -
  745.  
  746.  
  747.  
  748.     Save: continued
  749.  
  750.  
  751.  o  Filename to Save:  may have a Directory Path included with the
  752.                        filename; i.e.,  D:\DIR\PCBFILE.PIC
  753.  
  754.  o  You may press Esc at any time to cancel any field edits and
  755.     return to the Main Menu.
  756.  
  757.  o  It is a good idea to View a saved file to make sure you have
  758.     exactly what you intended to save.  Registered users should also
  759.     View the file with No Color, to make sure the file displays as
  760.     intended, in Black and White mode.
  761.  
  762.  o  If a filename already exists, Save will prompt:
  763.     Overwrite filename? Y/N [N]   Entering Y overwrites the file.
  764.  
  765.     ------------------------------------------------------------------
  766.  
  767.  
  768.             - If you have problems running TDXL and TheDraw -
  769.  
  770.  
  771.  o DO NOT RENAME THEDRAW.EXE to some other name.  TDXL will only work
  772.    if THEDRAW.EXE is used to load and run TheDraw.
  773.  
  774.  o TDXL was designed for use with TheDraw versions: 3.3, 4.1, 4.3, and 5.0
  775.    TDXL may not work with older versions of TheDraw, since they have
  776.    not been tested.
  777.  
  778.  o TheDraw SETUP:  TDXL works correctly with TheDraw when the default
  779.                    page size of 80 x 25 is the current setup.  Other
  780.                    TheDraw page sizes will scramble TDXL @X file Loads.
  781.  
  782.  
  783.  
  784.    
  785.                 -  Using TDXL as a stand alone program -  
  786.  
  787.              
  788.    TDXL can work outside of TheDraw to capture the current screen while
  789.    other programs are running.  
  790.  
  791.    For example:  ECHO OFF
  792.                  TYPE SCREEN.ANS (with ANSI.SYS color control codes)
  793.                  Press CTRL-T and SAVE the current screen with TDXL.
  794.  
  795.    For example:  While ON-LINE, press CTRL-T and SAVE the screen being
  796.                  viewed with TDXL, for later editing.
  797.  
  798.    Note:  TDXL may work with other screen drawing programs or editors, if
  799.           they use the video screen memory for screen storage buffers.
  800.           Use TDXL with other programs at your own risk.
  801.  
  802.               ------------------------------------------------ 
  803.  
  804.  
  805.  
  806.                                    - 13 -
  807.  
  808.  
  809.  
  810.                 - A Help List for PCBoard Screen Designers -
  811.  
  812.  
  813.   1. Limit the maximum size of your screens to 79 columns x 23 rows.
  814.  
  815.      TDXL supports a maximum page size of 80 x 25.  You are advised to limit
  816.      screen designs to 79 x 23, to allow for various communication programs.
  817.      Testing has shown some communication programs do not display 80 wide
  818.      screens correctly.  Using a maximum width of 79 characters seems to
  819.      correct this problem.
  820.  
  821.   2. ASCII codes below 32 (decimal) may not display, or may have side
  822.      effects, if included in screen designs.  Use low ASCII codes with
  823.      caution, and test the resulting file on-line.  Example: ProComm
  824.      displays ASCII code 16, while Qmodem does not.
  825.  
  826.   3. Color 0,0 (Black on Black) is ignored by PCBoard.  If you create
  827.      files with this color code, TDXL will set color 0,0 to Black on
  828.      White, during View or Load.
  829.  
  830.   4. If you are not a Sysop, do not create color PCBoard BBS messages,
  831.      without prior Sysop approval.   Messages with @X codes are not
  832.      supported by most offline mail readers.
  833.  
  834.   5. TDXL allows removal of the last CR/LF in the saved file.  This option
  835.      is available because PCBoard System Prompts begin with a CR/LF.
  836.      Assuming you have also included @CLS@ in a saved @X file and have 
  837.      removed the CR/LF from a screen with 22 lines, the next PCBoard
  838.      System Prompt will be on line 23, when displayed ON-LINE.
  839.  
  840.   6. Those who have used a program called CONVERT.EXE may be aware that
  841.      this program incorrectly interprets low ASCII codes (31 or less).
  842.  
  843.      Advice:  Use TDXL with TheDraw to include low ASCII codes.
  844.  
  845.   7. Those who have used a program called PCBdraw are advised this
  846.      partial clone of TheDraw, does not support a mouse and the
  847.      non-registered version does not support multiple pages.  PCBdraw
  848.      cannot read ANSI.SYS files or other formats supported by TheDraw.
  849.  
  850.      Compression routines used by PCBdraw, attempt to minimize the
  851.      @X file size, and in doing so, ignore the possibility of color wrap-
  852.      around.  This flaw appears when PCBoard sends a file created by
  853.      PCBdraw, and the color screen scrolls or is longer than 23 lines,
  854.      when received by a user's communication program.
  855.  
  856.      TDXL fixes this problem by always ending a line with the default
  857.      DOS color of Light Gray on Black, while still compressing the @X
  858.      files to a minimum size.
  859.  
  860.      Advice:  Use TDXL with TheDraw to get screens that don't color wrap.
  861.  
  862.   8. TDXL allows specifying the number of rows to Save from 1-25, a
  863.      feature lacking in PCBdraw.   One- or two-line custom prompts
  864.      might be created by a Sysop, if PCBoard allows them.  Or you might
  865.      wish to create short screens, for faster ON-LINE displays.
  866.  
  867.  
  868.                                    - 14 -
  869.  
  870.  
  871.  
  872.  
  873.  
  874.      Help List: continued
  875.  
  876.  
  877.   9. Consistent use of TDXL with TheDraw will eliminate the need to
  878.      have backup ANSI.SYS files of your screen designs.  And @X files
  879.      are likely to be smaller in size, than an equivalent ANSI.SYS
  880.      file.
  881.  
  882.  10. Those who have used a program called EXLIST:  TDXL imports @X files
  883.      directly to TheDraw.  Imported files can then be save in ANSI format
  884.      or many other formats, if desired.
  885.  
  886.      Advice: Use TDXL with TheDraw to import @X and save to ANSI.
  887.      
  888.  11. PCBoard @X files do not support ANSI.SYS ESC GOTO sequences;
  889.      therefore, screens designed for PCBoard systems cannot display
  890.      TheDraw Animation type files in @X formats.
  891.  
  892.  12. To create multiple page Newsletters or other long PCBoard @X
  893.      displays, SAVE each page with TDXL.  Then concatenate the files
  894.      with the DOS COPY command:
  895.  
  896.          COPY PAGE1 + PAGE2 + PAGE3
  897.  
  898.      You can scroll through and verify the long file, with TDXL, after
  899.      joining individual pages together.
  900.  
  901.  13. For faster and smaller PCBoard BBS ON-LINE screens, create designs
  902.      containing mostly blank spaces.   Screen designs have blank spaces
  903.      on the RIGHT SIDE of the screen will display faster than screens
  904.      surrounded with a box design.
  905.  
  906.      TDXL's compression scheme does not include blank spaces on the RIGHT
  907.      SIDE of the screen in the Saved file, if the spaces are drawn on a
  908.      BLACK background.
  909.  
  910.  14. If you need to have a series of non-expanding PCBoard @Command@
  911.      in the file, consider putting them in the first line of the
  912.      file; i.e., @QOFF@@CLS@ works nicely.  TDXL will ignore these
  913.      "invisible codes" when you Load a file containing them.  However,
  914.      they can be placed in a Saved file, by typing them in TheDraw before
  915.      you Save the file.  Be sure to test all files containing @COMMANDS@.
  916.  
  917.  15. If PCBoard users complain about not seeing the last part of the
  918.      LOG OFF screen, consider putting in @PAUSE@ in the last line
  919.      of the PCBoard @X file.  That way, they can press a key to
  920.      continue or they will automatically be logged off in 10 seconds.
  921.      They will see the whole LOG OFF screen, without truncation.
  922.  
  923.  16. Most users become bored with seeing the same Welcome screens.
  924.      And variety to your system with rotating Welcome screens.
  925.      Ask your users to create Welcome screens.  Have contests and
  926.      time rewards for the best screen designs.     
  927.  
  928.  
  929.  
  930.                                    - 15 -
  931.  
  932.  
  933.               
  934.  
  935.                        - Sample PCBoard @X screens -
  936.  
  937.        The TDXL-PCB.ZIP file should contain several sample screens.
  938.        Permission is granted to change or use these screens if you
  939.        wish to use them on your system.  One of these files is an
  940.        example of a PCBoard @X screen containing more than 25 lines.
  941.  
  942.  
  943.  
  944.  
  945.                             - Acknowledgments -
  946.  
  947.  
  948.     Thanks to all those who helped with the TDXL program development.
  949.  
  950.      Lynn Walker   Sysop of "The TIMEX BBS"         1-801-394-5010 (BBS)
  951.      Bart Flint    Sysop of "The Year 2000 Network" 1-801-547-0607 (BBS)
  952.  
  953.     Special THANKS to:
  954.  
  955.      Glenda Moore, CoSysop of "Year 2000 Network and Timex BBS"
  956.  
  957.     Many ideas incorporated into TDXL were included at Glenda's suggestion.
  958.     Glenda gets all the credit for debugging, testing, and putting up with
  959.     a sometimes cranky programmer.  The sample PCBoard screens include
  960.     examples of Glenda's PCBoard screen designs.  Glenda has designed
  961.     hundreds of PCBoard Welcome screens and now uses TDXL because it
  962.     makes previous methods obsolete.
  963.  
  964.  
  965.  
  966.                           - BBS Posting of TDXL -  
  967.  
  968.   o  TDXL-PCB.ZIP was originally posted on SALT AIR BBS, a BBS system
  969.      for registered owners of PCBoard BBS software, and not accessible
  970.      by the general public.
  971.  
  972.   o  TDXL-PCB.ZIP will also be posted on the TIMEX BBS and on 
  973.      the YEAR 2000 BBS, and other Local Area BBS systems.
  974.  
  975.   o  We encourage other Sysops to make TDXL-PCB.ZIP available to
  976.      friends, SysOps, and PCBoard screen designers.
  977.  
  978.  
  979.                        -------------------------------    
  980.  
  981.  
  982.    This document is a generic ASCII file, 16 pages long.  You may get
  983.    a Print-Out of TDXL.DOC by typing at the DOS command line:
  984.  
  985.    COPY TDXL.DOC PRN
  986.  
  987.  
  988.    -----------------------------------------------------------------------
  989.    TDXL.EXE and TDXL.DOC      Copyright (C) 1991          Fred Bertagnolli
  990.    -----------------------------------------------------------------------
  991.  
  992.                                    - 16 -
  993.